package com.witmore.neutron.ai.web.service;

/**
 * 短信服务接口
 * Author: 豆子高
 * Date: 2025/12/19
 */
public interface SmsService {

    /**
     * 发送验证码（登录场景）
     *
     * @param phone 手机号
     * @return 是否发送成功
     */
    boolean sendVerificationCode(String phone);

    /**
     * 发送验证码（指定场景）
     *
     * @param phone 手机号
     * @param scene 场景类型（LOGIN: 登录, BIND_PHONE: 绑定手机号）
     * @return 是否发送成功
     */
    boolean sendVerificationCode(String phone, String scene);

    /**
     * 验证验证码（登录场景）
     *
     * @param phone 手机号
     * @param code  验证码
     * @return 是否验证成功
     */
    boolean verifyCode(String phone, String code);

    /**
     * 验证验证码（指定场景）
     *
     * @param phone 手机号
     * @param code  验证码
     * @param scene 场景类型（LOGIN: 登录, BIND_PHONE: 绑定手机号）
     * @return 是否验证成功
     */
    boolean verifyCode(String phone, String code, String scene);
}
